home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / misc / wrip_21.lha / WRip / WRip.doc < prev    next >
Text File  |  1995-10-24  |  5KB  |  153 lines
  1.  
  2.     WRip 2.1 (23.10.95)
  3.     ===================
  4.  
  5. Introducing
  6.   WRip is a CLI util which scans input data for known formats and save them.
  7.   The input can be a NDOS Disk or a normal file.
  8.   
  9.   
  10. Requirements
  11.   MC68020 or better
  12.   Kickstart 2.05 (V37) or better
  13.   enough ram (disks will completely loaded to ram)
  14.   harddisk (strongly recommend)
  15.   
  16.  
  17. Disclaimer
  18.   No warranties of any kind are made as to the functionality of this
  19.   program. You are using it ENTIRE at your own risk.
  20.  
  21.  
  22. Installation
  23.   just copy WRip anywhere you like (e.g. C:)
  24.  
  25.  
  26. Using
  27.   - enter the directory where the ripped formats should stored (cd ...)
  28.     start WRip with input as argument (eg "WRip DF0:" or "WRip DH2:xyz.ab")
  29.      now WRip reads the disk / load the file
  30.      then it scans the data
  31.      if a format is recognized it will saved in the actual directory, the name
  32.      of the file is "format start_offset_in_source end_offset_in_source"
  33.   - its recommend to integrate WRip in your DirUtil (eg DOpus)
  34.     I use the following buttons : "WRip DF0:" "WRip RAD:" "WRip file" ...
  35.   - while WRip is loading or searching, you can break it with CTRL-C
  36.   - WRip is PURE and can made resident
  37.   - see CLI-Convention for further details
  38.  
  39.  
  40. WRip knows the follwing formats :
  41.   - Executable files ($000003F3), IFF files (FORM)
  42.   - various pack formats (ATM5, BOND, CrM2, CrM!, FIRE, ICE!, Ice!, IMP!,
  43.     LOB, PP20, RNC0, RNC1, RNC2, S300, S401, S403, S404, SSUR, TPWM, TSM!,
  44.     XPKF) and some clones (ATN!, CHFI, B6B2AFCB, Z&G!)
  45. WRip gives you a message if one of the following crunch-id's were found :
  46.   - GC!, LZWH, SFHD, SFCD, PX20, PACK, FVL, PIco, S310, S400, "T.S "
  47.     (I don't know exact the format therefore WRip can't rip them)
  48.  
  49.  
  50. The CLI-Convention
  51.   - Template :
  52.     WRip INPUT/A,SD=SAVEDISK/S,SB=SAVEBOOTEXE/S,NE=NOEXE/S,DEEP/S,
  53.          MU=MAXUNPACKED/K/N,MR=MAXRATIO/K/N,TASKPRI/K/N
  54.  
  55.     INPUT/A        specify the data which will loaded
  56.             if it ends with ":" it is interpreted as a Device
  57.             otherwise as a file
  58.  
  59.     SD=SAVEDISK/S    if WRip has read a disk (device), the whole disk will
  60.             saved as "BIN__FullDisk" after scan
  61.  
  62.     SB=SAVEBOOTEXE/S if WRip has read a disk the Bootblock will saved as
  63.             a standard amiga executable namely "EXE__BootBlock"
  64.             
  65.     NE=NOEXE/S    if specified WRip will not scan for Executables
  66.             makes sense if you scan an Executable and need no
  67.             duplication of them (hoho!)
  68.  
  69.     DEEP/S        select the DEEP mode
  70.             in normal mode the area of a saved format will skipped
  71.             (ie not scanned), in DEEP mode these areas will also
  72.             scanned (ie not skipped)
  73.     
  74.     MU=MAXUNPACKED/K/N with this option you can set the internal variable
  75.             with same name (e.g. ... MU=150000 ...)
  76.             for any packed file found, WRip will compare the
  77.             unpacked size of the file against MAXUNPACKED, if
  78.             MAXUNPACKED is lower the file won't saved
  79.             it makes no sense to save a file that is unpacked
  80.             50 MB or so...
  81.             lower values speeds up the PP20-trace !
  82.             default: MAXUNPACKED=2000000
  83.  
  84.     MR=MAXRATIO/K/N    set internal variable MAXRATIO
  85.             this var is only used in PP20-trace at the moment
  86.             the var describes how large the unpacked file can be
  87.             dependent on the size packed, or with other words :
  88.             "packedsize * MAXRATIO > unpackedsize" must be true
  89.             otherwise the file won't save
  90.             higher values than default will dramatically slow down
  91.             the trace-mode (see chapter PP20-trace)
  92.             default: MAXRATIO=4 (useful values 2...10)
  93.             
  94.     TASKPRI/K/N    with this option you can set the taskpriority of the
  95.             scanroutine, this is useful if you have a PP20-trace
  96.             which will take a long time, and want to do some
  97.             other things with your machine
  98.             default: TASKPRI=-3 (allowed values -10...10)
  99.  
  100.  
  101. PP20 trace-mode
  102.   - to rip PowerPacker files a special trace mode is used
  103.   - if a "PP20" ID will found WRip swiches to trace mode
  104.     the trace-mode will stopped if :
  105.       a valid PP20-file will recognized and saved
  106.       the next "PP20" ID will found
  107.       the end of file is reached
  108.       the user press CTRL-C (quits only the PP20-trace press again to leave
  109.       the program)
  110.   - important for the speed of the trace mode are the value of MAXUNPACKED
  111.     and MAXRATIO
  112.     e.g. if you want to rip a soundfile you can set MAXRATIO=2 because
  113.     PowerPacker is not able to compress real samples better than faktor 2
  114.     (gain ½ 50%)
  115.     see also CLI-Convention
  116.  
  117.             
  118. Other related Programms
  119.   - for decrunching the XFD-package (aminet:util/pack/xfd107.lha) is
  120.     recommend; note: some formats WRip saves are cloned from others
  121.     ATN!     -> IMP!
  122.     CHFI     -> IMP!
  123.     Z&G!     -> S404
  124.     B6B2AFCB -> S404
  125.     LR88     -> PP20
  126.     if XFD can't decrunch them you have to change manually the ID (hexedit)
  127.   - a good program for ripping soundmodules is ExoticRipper
  128.     (aminet:mus/misc/ExoticRip229.lha)
  129.  
  130.  
  131. Bugs
  132.   - files saved can be corrupt because only ID and sizes are checked
  133.     (except PP20 & SSUR they are always 100% clean)
  134.     the further process of corrupted files can crash other progs/your machine!
  135.   - not a bug :    never try to scan a FileSystemFormatted-Disk (resulting files
  136.         are waste, what else)
  137.  
  138.     
  139. Future plans
  140.   - new formats
  141.  
  142.  
  143. Contact
  144. EMail:    jah@pub.th-zwickau.de
  145. WWW:    http://www.th-zwickau.de/~jah
  146. Mail:    Bert Jahn
  147.     WE 9321
  148.     Otto-Hahn-Stra▀e 14
  149.     Zwickau
  150.     08066
  151.     Germany
  152.  
  153.